home *** CD-ROM | disk | FTP | other *** search
/ Alde ADA 5 #1 / ADA CD-ROM - Alde Publishing.iso / cm / adarpt.tid < prev    next >
Encoding:
Text File  |  1988-05-03  |  8.9 KB  |  210 lines
  1. --= TID = SIMTEL20 Ada Software Repository Item Description File = TID =--
  2. -- UNIT NAME         : ADARPT
  3. -- ORIGIN            : SIMTEL20
  4. -- REVIEW CODE       : 
  5. -- LOCATION          : ASR
  6. --= CLASSIFICATION       ===============================================--
  7. -- CATEGORY LEVEL 1  : Ada Software Repository
  8. -- CATEGORY LEVEL 2  : Introductory Information
  9. -- CATEGORY LEVEL 3  : Contents and Use of ASR
  10. -- CATEGORY LEVEL 4  : 
  11. -- KEYWORDS          : 
  12. -- INDEX             : ASR, Contents and Use
  13. -- INDEX             : Ada Software Repository
  14. -- TAXONOMY          : 
  15. -- DEPENDENCIES      : 
  16. -- SEE ALSO          : 
  17. --= FILE LISTING         ===============================================--
  18. -- FILE SPECS        : PD2:<ADA>ADA.CRCLST
  19. -- FILE SPECS        : PD2:<ADA>ADA.RPT
  20. -- FILE SPECS        : PD2:<ADA>ADA.SNP
  21. -- FILE SPECS        : PD2:<ADA>ADA.TAX
  22. -- FILE SPECS        : PD2:<ADA>ADA.UUE
  23. -- FILE SPECS        : PD2:<ADA>FILEUSE.DOC
  24. -- DIRECTORY DISPLAY : 
  25. -- Directory   PD2:<ADA>
  26. --      File Name     Byte Count  Line Count
  27. --   ---------------  ----------  ----------
  28. --   ADA.CRCLST            38048        1103
  29. --   ADA.RPT               68488        1101
  30. --   ADA.SNP                3638          48
  31. --   ADA.TAX                5641         253
  32. --   ADA.UUE                  35           4
  33. --   FILEUSE.DOC           79042        1032
  34. --   ===============  ==========  ==========
  35. --     6 Files            194892        3541
  36. --= ABSTRACT             ===============================================--
  37. --     Several files in the top-level PD2:<ADA> directory contain
  38. -- information on the contents of the Ada Software Repository.  These
  39. -- files are:
  40. --         ADA.CRCLST
  41. --         ADA.RPT
  42. --         ADA.SNP
  43. --         ADA.TAX
  44. --         ADA.UUE
  45. -- and
  46. --         FILEUSE.DOC
  47. --     Unlike the majority of files in the ASR, these files are
  48. -- updated frequently by the maintainer of the ASR in order to reflect
  49. -- changes made to the Ada Software Repository.
  50. -- 
  51. --     -- ADA.CRCLST and ADA.UUE --
  52. --     ----------------------------
  53. --     ADA.CRCLST contains a listing of all the files in the ASR by
  54. -- directory.  This listing includes the type of the file (always ASCII
  55. -- for the ASR), the size of each file in bytes, and a CRC (Cyclic
  56. -- Redundancy Check) value for the file.  The CRC value is useful in
  57. -- verifying that a given file was correctly transferred from the ASR
  58. -- into the user's environment; if the CRC of a file computed by a CRC
  59. -- Check program on the user's computer matches the CRC in this list, the
  60. -- user is assured that no errors occurred in file transfer.  There are
  61. -- many CRC Check programs for various environments (UNIX, IBM PC, etc)
  62. -- scattered throughout the various repositories on SIMTEL20.
  63. --     ADA.UUE is a copy of ADA.CRCLST that has been ARCed and then
  64. -- UUENCODED.  This process significantly reduces the size of the
  65. -- ADA.CRCLST file for transfer, thereby expediting the file transfer
  66. -- process IF the user has the ability on his host computer to decode the
  67. -- file (via UUENCODE) and the un-ARC it.
  68. --     A sample listing of the first few lines of the ADA.CRCLST file
  69. -- looks like the following:
  70. -- 
  71. -- Listing created Wednesday, December 30, 1987 15:22:01
  72. -- 
  73. --     Filename        Type     Bytes     CRC
  74. -- 
  75. -- PD2:<ADA.ADA-SQL>
  76. --     DAMES.CMM.1        ASCII       833  F5C0H
  77. --     DAMES.DOC.1        ASCII      5283  9A53H
  78. --     DAMES.PRO.2        ASCII      4913  4A99H
  79. --     DAMES.SRC.1        ASCII    616438  EE39H
  80. --     DAMESABS.DOC.1        ASCII      2139  68A7H
  81. -- 
  82. -- 
  83. --     -- ADA.RPT --
  84. --     -------------
  85. --     ADA.RPT is a report similiar to ADA.CRCLST except that a PAGER
  86. -- Hash code is provided instead of a CRC value, and a line count is
  87. -- given for each file (a line is terminated by an end-of-line character,
  88. -- as opposed to an Ada statement which is terminated by a semicolon).
  89. -- The PAGER Hash code is generated by the PAGER tool (not PAGER2,
  90. -- however) and by the FCHECK tool in the ASR, so the validity of a
  91. -- transferred file can be checked by using programs written in Ada
  92. -- rather than a CRC Check program (no Ada implementation is known to
  93. -- exist yet).
  94. --     A sample listing of the first few lines of the ADA.RPT file
  95. -- looks like the following:
  96. -- 
  97. -- Directory and File Name               Char Count Line Count Hash
  98. -- -----------------------               ---------- ---------- ----
  99. -- 
  100. -- PD2:<ADA.ADA-SQL>
  101. --   DAMES.CMM.1                                833         36   84
  102. --   DAMES.DOC.1                               5283        125   32
  103. --   DAMES.PRO.2                               4913         99  115
  104. --   DAMES.SRC.1                             616438      13534   73
  105. --   DAMESABS.DOC.1                            2139         46   42
  106. -- 
  107. --
  108. --     -- ADA.SNP --
  109. --     -------------
  110. --     The ADA.SNP file documents the sizes of each of the
  111. -- directories of the ASR.  The number of bytes and lines of source code
  112. -- and documentation in each directory is presented, and a summary of the
  113. -- entire Ada Software Repository is presented at the end of the report.
  114. --     A sample listing of the first few lines of ADA.SNP is as
  115. -- follows:
  116. -- 
  117. --                                 ---- Source Code ---- | --- Documentation ---
  118. -- Directory                       Byte Count Line Count | Byte Count Line Count
  119. -- -----------------------         ---------- ---------- | ---------- ----------
  120. -- PD:<ADA.ADA-SQL>                   1117750      30503 |     249705       6067
  121. -- PD:<ADA.AI>                         250984       7326 |     326909      10503
  122. -- PD:<ADA.ANSI-LRM>                        0          0 |    1201050      46091
  123. -- PD:<ADA.BENCHMARKS>                1844998      65965 |     546636      19174
  124. -- PD:<ADA.CAIS>                      1719047      50360 |      10742        216
  125. -- PD:<ADA.CAIS-TOOLS>                 152675       4442 |       7140        132
  126. -- PD:<ADA.COMPILATION-ORDER>          359990       8147 |      86428       2790
  127. -- 
  128. -- 
  129. --     -- ADA.TAX --
  130. --     -------------
  131. --     The file ADA.TAX contains a listing of the current taxonomy of
  132. -- the Ada Software Repository.  Internal to the ASR support programs,
  133. -- the taxonomy is maintained as an acyclic graph, but ADA.TAX presents
  134. -- it as a tree.  This taxonomy dynamically changes (typically as an
  135. -- upward-compatible extension to previous versions of the taxonomy) as
  136. -- the ASR grows.
  137. --     The following is a listing of a part of ADA.TAX:
  138. -- 
  139. -- BENCHMARKS
  140. --     GENERAL
  141. --         CAPACITY
  142. --         COMPUTATION-INTENSIVE, RECURSIVE
  143. --         PERFORMANCE ISSUES
  144. --     LANGUAGE COMPARISON
  145. --         ADA, C, FORTRAN, PASCAL
  146. --     TASKING
  147. --         TASKING 1
  148. --         TASKING 2
  149. -- 
  150. -- CAIS
  151. --     SPECIFIC IMPLEMENTATION
  152. --         MITRE CAIS
  153. --             EDITOR
  154. --             SOURCE CODE
  155. --             TEST ROUTINES
  156. -- 
  157. -- COMMUNICATIONS
  158. --     MESSAGE HANDLING
  159. --         RAINFORM
  160. --         UNITREP SOFTWARE MODEL
  161. --     PROTOCOL
  162. --         FTP/SMTP
  163. --         SMTP
  164. --         TCP/IP
  165. --         TELNET
  166. -- 
  167. -- COMPONENTS
  168. --     CHARACTER SET
  169. --     COMMAND LANGUAGE INTERPRETER
  170. --     COMPOOLS IN ADA
  171. --     CONTEXT-DIRECTED UPDATE
  172. --     COUNT ADA STATEMENTS
  173. --         COUNT OF ADA STATEMENTS 1
  174. --         COUNT OF ADA STATEMENTS 2
  175. --         COUNT OF ADA STATEMENTS 3
  176. -- 
  177. --     -- FILEUSE.DOC --
  178. --     -----------------
  179. --     FILEUSE.DOC lists all files in the subdirectories under
  180. -- PD2:<ADA> in order of the number of accesses.  Presented are the
  181. -- directory and file name, the total number of accesses, the average
  182. -- monthly rate of access, and the size of the file in terms of 2048-byte
  183. -- disk pages.
  184. --     The following is a sample of the first few lines of a typical
  185. -- FILEUSE.DOC file:
  186. -- 
  187. -- [PHOTO:  Recording initiated  Wed 30-Dec-87 3:32PM]
  188. -- 
  189. -- @
  190. --    name                                     # refs,     rate/month,     size.
  191. -- <ADA.COMPONENTS>LIST.ADA.2                  502              13       7 pgs
  192. -- <ADA.COMPONENTS>ABSTRACT.SRC.1              467              15     224 pgs
  193. -- <ADA.PAGER>PAGER.SRC.5                      456              17      34 pgs
  194. -- <ADA.BENCHMARKS>BENCH.DOC.1                 451              15       3 pgs
  195. -- <ADA.AI>EXPERT.ADA.1                        445              17      15 pgs
  196. -- 
  197. --= DISCLAIMER           ===============================================--
  198. --     These documents are provided "AS IS" and without any expressed
  199. -- or implied warranties whatsoever.  No warranties as to performance,
  200. -- merchantability, or fitness for a particular purpose exist.
  201. --     The user must assume the entire risk and liability of using
  202. -- these documents and the information contained therein.  In no event
  203. -- shall any person or organization of people be held responsible for any
  204. -- direct, indirect, consequential or inconsequential damages or lost
  205. -- profits.
  206. --     Statements made by individuals in these documents are their
  207. -- own and should not necessarily be considered to be the official
  208. -- positions of their respective companies or organizations.
  209. --======================================================================--
  210.